Multi-ROI Pop-Up Menu

Opens the Dataset Properties panel, in which the basic and advanced properties related to a multi-ROI can be viewed and modified (see Modifying Image Properties).

The following options are available to modify and transform multi-ROIs.

Crop

Opens the Dataset Cropper panel. In this panel you can crop a multi-ROI (see Cropping Datasets).

After cropping a multi-ROI, it is usually best to remove empty labels. It may also be necessary to re-analyze the multi-ROI after cropping (see Remove Empty Labels).

Crop to Bounding Box

Automatically crops the region of interest to the bounding box that encapsulates the labeled voxels of the multi-ROI.

Sample

Opens the Dataset Sampler panel, in which you can modify spacing by upsampling or downsampling (see Sampling Datasets).

Resample Geometry

Copies the intersected values of the selected multi-ROI(s) into the geometry, or shape, of another object to create a new multi-ROI (see Resampling Geometries). This can be necessary if you intend to create a training set that includes the multi-ROI.

After resampling a multi-ROI, it is usually best to remove empty labels (see Remove Empty Labels). It may also be necessary to re-analyze the multi-ROI (see Analyzing Connected Components)

Invert

Opens the Dataset Inverter panel. In this panel you can invert the X, Y, and Z axes of the multi-ROI, as well as apply an axis transformation (see Inverting Datasets).

Apply Transformation From

Automatically applies transformations, such as translations and rotations, that were applied to a reference object to the selected multi-ROI.

You should note that only objects that were previously transformed will be available as a reference in the Choose an Object dialog, shown below.

The following options are available to align multi-ROIs with the current scene views.

With Current View… Automatically rotates the selected multi-ROI so that the selected axis is aligned to the Z-axis of the world coordinate system.

Automatically rotates the selected multi-ROI so that the selected axis is aligned to the Z-axis of the world coordinate system.

Centroid With

Automatically aligns the centroid of the selected multi-ROI with the centroid of another object. Applicable objects include volumetric image data, regions of interest, other multi-ROIs, and meshes. Reference objects can be selected in the Choose the Object to Align With dialog.

The following options are available for refining multi-ROIs.

Remove Objects That Touch Another ROI or Multi-ROI

Automatically removes objects, which can be defined as groups of labeled voxels that are connected, within the selected multi-ROI that intersect with an ROI or multi-ROI.

In the example below, the objects in the multi-ROI with the orange circles that were touching the blue ROI were removed.

How to Remove Objects That Touch Another ROI or Multi-ROI

1. Right-click the multi-ROI you need to modify and then choose Refine Region of Interest > Remove Objects That Touch Another ROI or Multi-ROI in the pop-up menu.
2. Choose the ROI or multi-ROI that is touching parts of the multi-ROI that you are modifying in the Choose ROI or Multi-ROI dialog.

   

3. Click OK.

   Touching objects are removed automatically from the selected multi-ROI.

Remove Empty Labels

Removes all labels that do not contain any data. This can occur after resampling the shape of a multi-ROI or after objects have been removed in the Object Analysis panel.

Provides options for isolating the connected components in a multi-ROI and analyzing multi-ROIs.

New Multi-ROI (6-Connected)

Creates a new multi-ROI. in which connectivity is determined strictly using the 6 faces adjacent to the current seed.

New Multi-ROI (26-Connected)

Creates a new multi-ROI. in which connectivity is determined using the 6 faces, 12 edges, and 8 corners adjacent to the current seed.

Analysis

Opens the Object Analysis dialog, in which you can further analyze the multi-ROI (see Analyzing Connected Components).

Provides options for generating convex hulls from multi-ROIs. You should note that some of the following options may not be available if the selected multi-ROI contains an excessive number of labeled objects.

As a Multi-ROI, Each Label Being Filled

Generates a series of convex hulls, as filled objects, for each connected component contained in the selected multi-ROI (see Generating Convex Hulls).

As a Multi-ROI, Each Label as an Outer Shell ROI

Generates a series of convex hulls, as outlined objects, for each connected component contained in the selected multi-ROI (see Generating Convex Hulls).

As a Mesh for Each Multi-ROI Label

Generates a series of convex hulls, as outlined objects, for each connected component contained in the selected multi-ROI (see Generating Convex Hulls).

Lets you compute a Watershed segmentation, in which the labeled objects in the selected multi-ROI will be used as the seed points and the expanded components will then be overwritten into the initial multi-ROI (see Computing Watersheds).

Lets you compute a Watershed segmentation, in which the labeled objects in the selected multi-ROI will be used as the seed points and the expanded components will then be overwritten into the initial multi-ROI (see Computing Watersheds 2D).

The following options are available for creating meshes from multi-ROIs.

Create Mesh

Creates a mesh in which each vertice contains a corresponding scalar value.

Note In some cases, duplications of values will occur when the multi-ROI is converted into a scalar mesh.

Create Cubic Mesh

Creates a cubic mesh in which each vertice contains a corresponding scalar value.

Note In some cases, duplications of values will occur when the multi-ROI is converted into a scalar mesh.

The following options are available for creating new box shapes from multi-ROIs.

Current Bounding Box

Automatically creates a box that corresponds to the dimensions of the labeled voxels in the selected multi-ROI.

Current Box

Automatically creates a box that corresponds to the dimensions of labeled and unlabeled voxels in the selected multi-ROI.

Current Clip Box

Automatically creates a box that corresponds to the dimensions of the clip box applied to the selected multi-ROI.

Allows you to save reformations, such as oblique and double-obliques, that were applied with the Walk tool or by other methods. The result is a new multi-ROI formatted in the current space (see Deriving New Volumes from the Current View).

The following options are available for exporting multi-ROIs.

Export as ORSObject

Exports the multi-ROI in the ORS Object (*.ORSObject extension) file format (see Exporting Objects).

ORS files are proprietary binary formatted files in which data is written sequentially and XML (Extensible Markup Language) is appended after the binary data. Scalar information contained in the file will be conserved whenever multi-ROIs are exported in this format.

Export Measurements Table

Lets you export data in the multi-labeled ROI in the comma-separated values (*.csv extension) file format.

To CZI

Exports the selected items in the CZI file format (*.czi extension).

This option is available for Dragonfly Pro only. Contact Object Research Systems for information about the availability of this version of Dragonfly.

Opens the Measurement Inspection panel, in which you can plot statistical properties on a histogram and highlight selections in 2D and 3D views (see Using the Measurement Inspector).

Provides a shortcut for selecting macros that can be executed for a single multi-ROI.

Opens the User Data dialog, in which you can view detailed object descriptions, as well as add fields to further describe the selected multi-ROI (see User Data).

Lets you delete selected measurements from the multi-ROI. You can select multiple scalar value slots when deleting scalar information, as shown below.

Lets you import scalar values contained in a selected comma-separated values file (*.CSV extension). You can import scalar values from either an ORS-formatted CSV file, in which case all slots will be imported, or you can import scalar values from a generic CSV file that contains the required IDs and corresponding values.

The options for importing scalar values from a generic CSV file are available in the Scalar Values Slots Importer dialog, shown below.

NOTE ORS-formatted CSV files are formatted in columns as follows: | Object-Name | Time Step | ID | Unit | Value |, in which the ID can be a vertex, edge, or face for meshes and a label for multi-ROIs. Generic CSV files must be formatted as: | ID | Value |. Other information, such as slot title can be entered manually.

Lets you copy selected measurements contained within a multi-ROI to another multi-ROI. You can choose the multi-ROI that includes the scalar values you want to copy to the selected multi-ROI in the Choose a Scalar Value dialog.

Lets you graph the inter-relationship between connected components (see Graphing Multi-ROIs).

Adds a new class to the multi-ROI in which all unlabeled voxels are labeled.

Creates a dataset in which each object in the multi-ROI is assigned a different value. If the multi-ROI contains 1,000 objects, then the resulting dataset will have 1,000 values with each value corresponding to a distinct object.

Creates an ROI that consolidates all distinct (labeled) objects in the multi-ROI into a new region of interest.

Extracts a new region of interest from each connected component in the selected multi-ROI.

For example, if there are 100 connected components in the selected multi-ROI, then selecting the Extract ROIs item will result in 100 new regions of interest — one for each connected component — being added to the Data Properties and Settings panel .

Creates a new multi-ROI with one labeled connected component from a multi-ROI that contains a number of labels that were merged. For example, through a Boolean operation.

Lets you create a new multi-ROI in which objects with the same label that are not connected are split. For example, when you create a greylevel multi-ROI from a dataset (see New Greylevel Multi-ROI).

In the following example, the original multi-ROI with six labeled objects extracted from the data values of dataset (using the option New Greylevel Multi-ROI) is on the left. After splitting the non-connected labels of the greylevel multi-ROI, there are 165 labeled objects, as shown on the right.

Results of splitting non-connected labels

Transforms a multi-ROI by applying a Watershed segmentation using the labeled objects in the multi-ROI as the seed points and a selected dataset as the landscape image (see Watershed Transforms).

Exports the selected items in the ORS Object file format (*.ORSObject extension) to a selected folder as multiple files (see Exporting Objects).

Note If the selected items share the same name, their file names will be appended with a sequential number.

Exports the selected items to an ORS Object File (*.ORSObject extension) to a selected folder (see Exporting Objects).

Exports the selected items in the CZI file format (*.czi extension).

Provides a shortcut for selecting macros that can be executed for the number of items selected.

Automatically rotates the multi-ROIs so that the selected axis is aligned to the Z-axis of the world coordinate system.

Automatically computes the interfacial surface, which is defined as the boundary between two phases, for the selected multi-ROIs. You should note that computations are performed in 3D with interpolated surfaces, not with pixel-wise methods.

Generates a normal, sampled, or cubic mesh that describes the interfacial surface, which is defined as the boundary between two phases, for the selected multi-ROIs.

Lets you extract a graph of the three-phase boundary shared between selected regions of interest and to compute pore throat thickness (see Graphing Three-Phase Boundaries).

Lets you extract a graph of the three-phase boundary shared between selected regions of interest (see Graphing Three-Phase Boundaries).

Copies the intersected values of the selected multi-ROIs into the geometry, or shape, of another object (see Resampling Geometries).